IMAPISupport : IUnknown

The IMAPISupport interface provides implementations for tasks that are commonly performed by service providers and message service entry point functions. Service providers receive a pointer to their support object when MAPI calls their provider object s logon method; message services receive their support object pointer in the call to their entry point function.

Quick Info

Header file:

MAPISPI.H

Exposed by:

Support objects

Implemented by:

MAPI

Called by:

Service providers

Corresponding pointer type:

LPMAPISUP

 

Vtable Order

GetLastErrorHW29U0

Returns a MAPIERROR4GS6AI structure containing information about the previous support object error.

GetMemAllocRoutinesLH2.5I

Retrieves the addresses of the MAPI memory allocation and deallocation functions: MAPIAllocateBuffer1MW3BAZ, MAPIAllocateMoreB1SGX_, and MAPIFreeBuffer16U06F.

Subscribe12ZZE25

Registers an advise sink to receive notifications through MAPI.

Unsubscribe13W.OZT

Cancels the responsibility for sending notifications that was previously established with a call to the IMAPISupport::Subscribe method.

Notify_B4TJY

Sends a notification of a specified event to an advise source that originally registered for the notification through IMAPISupport::Subscribe.

ModifyStatusRowF5S5Z4

Modifies the status table by adding a new row or modifying an existing row.

OpenProfileSectionJSWD36

Opens a section of the current profile and returns an IProfSect pointer for further access

RegisterPreprocessor3EQ._.U

Registers a transport provider s preprocessor function, a function that conforms to the PreprocessMessage1OGBDB_ prototype.

NewUID_885MD

Creates a new MAPIUIDT02NXD structure to be used as a unique identifier.

MakeInvalidLODT0M

Marks an object as unusable.

SpoolerYieldYSQ8WN

Gives control of the CPU to the the MAPI spooler so that it can perform any tasks it deems necessary.

SpoolerNotifyRYSE6K

Notifies the MAPI spooler of a change in status or a request for service.

CreateOneOff3M69_M_

Creates an entry identifier for a one-off address.

SetProviderUID1O.AZ2O

Registers a MAPIUID structure that uniquely represents the service provider.

CompareEntryIDs_A5HY0

Compares two entry identifiers to determine if they refer to the same object.

OpenTemplateID53ZEKH

Opens a recipient entry in a foreign address book provider.

OpenEntryJ8UVAW

Opens an object and returns an interface pointer for further access.

GetOneOffTable9.IXQE

Returns a pointer to MAPI s one-off table, a list of templates supported by all address book providers for creating new recipients.

Address6P2ISS

Displays the common address dialog box.

Details16CSO1N

Displays a modal dialog box showing details about a particular address book entry.

NewEntry2HC4M5P

Adds a new recipient directly to an address book container or to the recipient list of an outgoing message.

DoConfigPropsheetWGCBY2

Displays a configuration property sheet.

CopyMessagesMGAIJ4

Copies or moves messages from one folder to another folder.

CopyFolderNQ7MNK

Copies or moves a folder from its current parent folder to another parent folder.

DoCopyToKIW0ZO

Copies or moves all properties of one object, except for specifically excluded properties, to another object.

DoCopyPropsLUP5BM

Copies or moves one or more properties of an object to another object.

DoProgressDialog31XNWXP

Retrieves a progress object for displaying a progress indicator.

ReadReceipt3MVP02S

Generates a read or nonread report for a message.

PrepareSubmit1K5RRVS

Prepares a message for submission to the MAPI spooler.

ExpandRecips1_1QX1N

Completes a message s recipient list, expanding particular distribution lists.

DoSentMail2FLHEPP

Performs processing on a sent message.

OpenAddressBookCKS_79

Provides access to the address book.

CompleteMsgOJ7P4M

Performs postprocessing on a message.

StoreLogoffTransportsE6DYO4

Requests the orderly release of a message store.

StatusRecips0BDBIL

Generates delivery and nondelivery reports.

WrapStoreEntryIDHH.8AF

Converts a message store s internal entry identifier to an entry identifier in MAPI s standard format.

ModifyProfile1832SLO

Makes the profile section for a message store provider permanent.

IStorageFromStream.C6IG8

Implements a storage object to access a stream.

GetSvcConfigSupportObjXY.E5V

Creates a message service support object.

 

Remarks

There are four different support objects, one for address book, message store, and transport providers and and one for message services. Service providers and message services call the methods in their support objects as part of their implementations of other interface methods. Each different support object has complete implementations of the methods that are applicable to its caller; the methods that are not applicable return MAPI_E_NO_SUPPORT.

Address book provider support objects have implementations for the following methods:

 

Address

CompareEntryIDs

CreateOneOff

Details

DoConfigPropsheet

DoProgressDialog

GetLastError 

GetMemAllocRoutines

GetOneOffTable

IStorageFromStream

GetSvcConfigSupportObj

MakeInvalid

ModifyStatusRow  

NewEntry

NewUID

Notify

OpenAddressBook

OpenEntry

OpenProfileSection

OpenTemplateID

SetProviderUID 

Subscribe

Unsubscribe

WrapStoreEntryID

 

Message store provider support objects have implementations for the following methods:

 

CompareEntryIDs

CompleteMsg

CopyFolder

CopyMessages

CreateOneOff

DoCopyProps

DoCopyTo

DoConfigPropsheet

DoProgressDialog

DoSentMail

ExpandRecips

GetLastError

GetMemAllocRoutines

GetSvcConfigSupportObj

MakeInvalid

IStorageFromStream

ModifyProfile

ModifyStatusRow 

NewUID

Notify

OpenAddressBook

OpenEntry

OpenProfileSection

PrepareSubmit 

ReadReceipt

SetProviderUID 

SpoolerNotify

StoreLogoffTransports

Subscribe

Unsubscribe

WrapStoreEntryID

 

 

 

Transport provider support objects have implementations for the following methods:

 

DoConfigPropsheet

CompareEntryIDs

CreateOneOff

GetMemAllocRoutines

GetSvcConfigSupportObj

GetLastError

IStorageFromStream

MakeInvalid

ModifyStatusRow

OpenAddressBook

RegisterPreprocessor

NewUID

Notify

OpenProfileSection

OpenEntry

StatusRecips

SpoolerNotify

SpoolerYield

WrapStoreEntryID

Subscribe

Unsubscribe

 

Message service support objects have implementations for the following methods:

 

DoConfigPropsheet

GetLastError

GetMemAllocRoutines

GetSvcConfigSupportObj

MakeInvalid

NewUID

OpenProfileSection